home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / Xm / XmClipboardInquireCount.z / XmClipboardInquireCount
Encoding:
Text File  |  2001-04-17  |  5.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeCCCCoooouuuunnnntttt((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeCCCCoooouuuunnnntttt((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeCCCCoooouuuunnnntttt - A clipboard function that returns
  10.           the number of data item formats
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/CutPaste.h>
  14.           int XmClipboardInquireCount (_d_i_s_p_l_a_y, _w_i_n_d_o_w, _c_o_u_n_t,
  15.                   _m_a_x__f_o_r_m_a_t__n_a_m_e__l_e_n_g_t_h)
  16.                   Display * _d_i_s_p_l_a_y;
  17.                   Window  _w_i_n_d_o_w;
  18.                   int     * _c_o_u_n_t;
  19.                   unsigned long   * _m_a_x__f_o_r_m_a_t__n_a_m_e__l_e_n_g_t_h;
  20.           (vvvvooooiiiidddd)
  21.  
  22.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  23.           This page documents Motif 2.1.
  24.  
  25.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.           XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeCCCCoooouuuunnnntttt returns the number of data item
  27.           formats available for the data item in the clipboard. This
  28.           function also returns the maximum name-length for all
  29.           formats in which the data item is stored.
  30.  
  31.           _d_i_s_p_l_a_y   Specifies a pointer to the DDDDiiiissssppppllllaaaayyyy structure that
  32.                     was returned in a previous call to XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy or
  33.                     XXXXttttDDDDiiiissssppppllllaaaayyyy.
  34.  
  35.           _w_i_n_d_o_w    Specifies the window ID of a widget that relates
  36.                     the application window to the clipboard. The
  37.                     widget's window ID can be obtained through
  38.                     XXXXttttWWWWiiiinnnnddddoooowwww.  The same application instance should
  39.                     pass the same window ID to each of the clipboard
  40.                     functions that it calls.
  41.  
  42.           _c_o_u_n_t     Returns the number of data item formats available
  43.                     for the data item in the clipboard. If no formats
  44.                     are available, this argument equals 0 (zero). The
  45.                     count includes the formats that were passed by
  46.                     name.
  47.  
  48.           _m_a_x__f_o_r_m_a_t__n_a_m_e__l_e_n_g_t_h
  49.                     Specifies the maximum length of all format names
  50.                     for the data item in the clipboard.
  51.  
  52.      RRRREEEETTTTUUUURRRRNNNN
  53.           _X_m_C_l_i_p_b_o_a_r_d_S_u_c_c_e_s_s
  54.                     The function was successful.
  55.  
  56.           _X_m_C_l_i_p_b_o_a_r_d_L_o_c_k_e_d
  57.                     The function failed because the clipboard was
  58.                     locked by another application. The application can
  59.                     continue to call the function again with the same
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 4/6/01)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeCCCCoooouuuunnnntttt((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeCCCCoooouuuunnnntttt((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                     parameters until the lock goes away. This gives
  75.                     the application the opportunity to ask if the user
  76.                     wants to keep trying or to give up on the
  77.                     operation.
  78.  
  79.           _X_m_C_l_i_p_b_o_a_r_d_N_o_D_a_t_a
  80.                     The function could not find data on the clipboard
  81.                     corresponding to the format requested. This could
  82.                     occur because the clipboard is empty; there is
  83.                     data on the clipboard, but not in the requested
  84.                     format; or the data in the requested format was
  85.                     passed by name and is no longer available.
  86.  
  87.      RRRREEEELLLLAAAATTTTEEEEDDDD
  88.           XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddSSSSttttaaaarrrrttttCCCCooooppppyyyy(3).
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 4/6/01)
  130.  
  131.  
  132.  
  133.